<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>IupGetDialogChild</title>

<link rel="stylesheet" type="text/css" href="../../style.css">
<style type="text/css">
.style1 {
	font-size: large;
}
.style2 {
	text-decoration: underline;
}
</style>
</head>
<body>

<h2>IupGetDialogChild<span class="style1"> (since 3.0)</span></h2>
<p>Returns the identifier of the child element that has the NAME attribute 
equals to the given value on the same dialog hierarchy. Works also for children 
of a menu that is associated with a dialog.</p>
<h3>
Parameters/Return</h3>
<pre>Ihandle* IupGetDialogChild(Ihandle *<strong>ih</strong>, const char* <strong>name</strong>); [in C]
iup.GetDialogChild(<strong>ih</strong>: ihandle, <strong>name</strong>: string) -&gt; (<strong>ih</strong>: ihandle) [in Lua]</pre>
<p><b>ih</b>: Identifier of an interface element that belongs to the hierarchy.<br>
<strong>name</strong>: name of the control to be found</p>
<p><span class="style2">Returns:</span> NULL if not found.</p>
<h3>Notes</h3>
<p>This function will only found the child if the NAME attribute is set at the 
control.</p>
<p>Before the dialog is mapped the function searches the hierarchy, even if the 
hierarchy does not belongs to a dialog yet, but after 
the child is mapped the result is immediate (the hierarchy is not searched).</p>
<h3>See Also</h3>
<p><a href="../attrib/iup_name.html">NAME</a></p>

</body>

</html>
